Node / meshtastic / Meshtastic-Android / files / feature / discovery / src / commonMain / kotlin / org / meshtastic / feature / discovery / ai / DiscoverySummaryAiProvider.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.discovery.ai

Tff7b72import T7ee787org.meshtastic.core.database.entity.DiscoveryPresetResultEntity

Tff7b72import T7ee787org.meshtastic.core.database.entity.DiscoverySessionEntity

T8b949e/**

* Abstraction for generating natural-language summaries of discovery scan results.

*

* Platform implementations may use on-device AI (e.g. Gemini Nano on Android) or fall back to the algorithmic

* [org.meshtastic.feature.discovery.DiscoverySummaryGenerator].

*/

Tff7b72interface T56d364DiscoverySummaryAiProvider Tb4b4b4{

T8b949e/** Whether this provider is ready to generate AI summaries. */

Tff7b72val Te6edf3isAvailableTb4b4b4: Tffa657Boolean

T8b949e/** Generate a session-level summary across all preset results. Returns `null` on failure. */

Tff7b72suspend Tff7b72fun Td2a8ffgenerateSessionSummaryTb4b4b4(

Te6edf3sessionTb4b4b4: Te6edf3DiscoverySessionEntityTb4b4b4,

Te6edf3presetResultsTb4b4b4: Te6edf3ListTff7b72<Te6edf3DiscoveryPresetResultEntityTff7b72>Tb4b4b4,

Tb4b4b4)Tb4b4b4: Tffa657String?

T8b949e/** Generate a per-preset summary. Returns `null` on failure. */

Tff7b72suspend Tff7b72fun Td2a8ffgeneratePresetSummaryTb4b4b4(Te6edf3resultTb4b4b4: Te6edf3DiscoveryPresetResultEntityTb4b4b4)Tb4b4b4: Tffa657String?

Tb4b4b4}